﻿//////////////////////////////////////////////////////////////////////////////
//
//  Copyright © 1998-2024 Glodon Company Limited.  All rights reserved.
//
//  Use of this software is subject to the terms of the Glodon license
//  agreement provided at the time of installation or download, or which
//  otherwise accompanies this software in either electronic or hard copy form.  
//
//////////////////////////////////////////////////////////////////////////////


#pragma once

#include "GcmpApplicationInterface.h"
#include "GcmpApiDeclaration.h"

namespace gcmp
{
    /// \brief 程序关闭策略
    ///
    /// 允许开发者注册自己的程序关闭策略
    /// \see IApplication
    class GCMP_APPLICATION_INTERFACE_EXPORT IApplicationCloseStrategy
    {
    public:
        /// \brief 开发者定制的关闭行为
        ///
        /// 被调用顺序在平台发送ApplicationEventType::PreClose事件后，执行平台关闭行为前。
        /// 平台的关闭行为是：依次询问被修改过的文件是否需要保存。
        ///
        /// \return bool 是否继续执行。如果返回true，则继续执行，否则不执行后续逻辑（即不再继续执行关闭行为）。
        virtual bool Close() = 0;

        /// \brief 在定制的关闭行为之后，是否继续执行平台的关闭行为。
        /// \return bool 返回true表示继续执行平台的关闭行为；返回false表示不继续执行平台的关闭行为。
        virtual bool ShouldContinueBuiltInCloseAfterThisCloseWasCalled() const = 0;

        /// \brief 析构函数
        virtual ~IApplicationCloseStrategy();      
    };
}
